home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / developer-tools / andere sprachen / perl5 / perl5.002 / gv.c < prev    next >
Encoding:
C/C++ Source or Header  |  1996-02-15  |  26.8 KB  |  1,196 lines
  1. /*    gv.c
  2.  *
  3.  *    Copyright (c) 1991-1994, Larry Wall
  4.  *
  5.  *    You may distribute under the terms of either the GNU General Public
  6.  *    License or the Artistic License, as specified in the README file.
  7.  *
  8.  */
  9.  
  10. /*
  11.  *   'Mercy!' cried Gandalf.  'If the giving of information is to be the cure
  12.  * of your inquisitiveness, I shall spend all the rest of my days answering
  13.  * you.  What more do you want to know?'
  14.  *   'The names of all the stars, and of all living things, and the whole
  15.  * history of Middle-earth and Over-heaven and of the Sundering Seas,'
  16.  * laughed Pippin.
  17.  */
  18.  
  19. #include "EXTERN.h"
  20. #include "perl.h"
  21.  
  22. extern char rcsid[];
  23.  
  24. GV *
  25. gv_AVadd(gv)
  26. register GV *gv;
  27. {
  28.     if (!gv || SvTYPE((SV*)gv) != SVt_PVGV)
  29.     croak("Bad symbol for array");
  30.     if (!GvAV(gv))
  31.     GvAV(gv) = newAV();
  32.     return gv;
  33. }
  34.  
  35. GV *
  36. gv_HVadd(gv)
  37. register GV *gv;
  38. {
  39.     if (!gv || SvTYPE((SV*)gv) != SVt_PVGV)
  40.     croak("Bad symbol for hash");
  41.     if (!GvHV(gv))
  42.     GvHV(gv) = newHV();
  43.     return gv;
  44. }
  45.  
  46. GV *
  47. gv_IOadd(gv)
  48. register GV *gv;
  49. {
  50.     if (!gv || SvTYPE((SV*)gv) != SVt_PVGV)
  51.     croak("Bad symbol for filehandle");
  52.     if (!GvIOp(gv))
  53.     GvIOp(gv) = newIO();
  54.     return gv;
  55. }
  56.  
  57. GV *
  58. gv_fetchfile(name)
  59. char *name;
  60. {
  61.     char tmpbuf[1200];
  62.     GV *gv;
  63.  
  64.     sprintf(tmpbuf,"::_<%s", name);
  65.     gv = gv_fetchpv(tmpbuf, TRUE, SVt_PVGV);
  66.     sv_setpv(GvSV(gv), name);
  67.     if (*name == '/' && (instr(name,"/lib/") || instr(name,".pm")))
  68.     GvMULTI_on(gv);
  69.     if (perldb)
  70.     hv_magic(GvHVn(gv_AVadd(gv)), gv, 'L');
  71.     return gv;
  72. }
  73.  
  74. void
  75. gv_init(gv, stash, name, len, multi)
  76. GV *gv;
  77. HV *stash;
  78. char *name;
  79. STRLEN len;
  80. int multi;
  81. {
  82.     register GP *gp;
  83.  
  84.     sv_upgrade(gv, SVt_PVGV);
  85.     if (SvLEN(gv))
  86.     Safefree(SvPVX(gv));
  87.     Newz(602,gp, 1, GP);
  88.     GvGP(gv) = gp_ref(gp);
  89.     GvREFCNT(gv) = 1;
  90.     GvSV(gv) = NEWSV(72,0);
  91.     GvLINE(gv) = curcop->cop_line;
  92.     GvFILEGV(gv) = curcop->cop_filegv;
  93.     GvEGV(gv) = gv;
  94.     sv_magic((SV*)gv, (SV*)gv, '*', name, len);
  95.     GvSTASH(gv) = stash;
  96.     GvNAME(gv) = savepvn(name, len);
  97.     GvNAMELEN(gv) = len;
  98.     if (multi)
  99.     GvMULTI_on(gv);
  100. }
  101.  
  102. static void
  103. gv_init_sv(gv, sv_type)
  104. GV* gv;
  105. I32 sv_type;
  106. {
  107.     switch (sv_type) {
  108.     case SVt_PVIO:
  109.     (void)GvIOn(gv);
  110.     break;
  111.     case SVt_PVAV:
  112.     (void)GvAVn(gv);
  113.     break;
  114.     case SVt_PVHV:
  115.     (void)GvHVn(gv);
  116.     break;
  117.     }
  118. }
  119.  
  120. GV *
  121. gv_fetchmeth(stash, name, len, level)
  122. HV* stash;
  123. char* name;
  124. STRLEN len;
  125. I32 level;
  126. {
  127.     AV* av;
  128.     GV* topgv;
  129.     GV* gv;
  130.     GV** gvp;
  131.     HV* lastchance;
  132.     CV* cv;
  133.  
  134.     if (!stash)
  135.     return 0;
  136.     if (level > 100)
  137.     croak("Recursive inheritance detected");
  138.  
  139.     gvp = (GV**)hv_fetch(stash, name, len, TRUE);
  140.  
  141.     DEBUG_o( deb("Looking for method %s in package %s\n",name,HvNAME(stash)) );
  142.     topgv = *gvp;
  143.     if (SvTYPE(topgv) != SVt_PVGV)
  144.     gv_init(topgv, stash, name, len, TRUE);
  145.  
  146.     if (cv=GvCV(topgv)) {
  147.     if (GvCVGEN(topgv) >= sub_generation)
  148.         return topgv;    /* valid cached inheritance */
  149.     if (!GvCVGEN(topgv)) {    /* not an inheritance cache */
  150.         return topgv;
  151.     }
  152.     else {
  153.         /* stale cached entry, just junk it */
  154.         GvCV(topgv) = cv = 0;
  155.         GvCVGEN(topgv) = 0;
  156.     }
  157.     }
  158.     /* if cv is still set, we have to free it if we find something to cache */
  159.  
  160.     gvp = (GV**)hv_fetch(stash,"ISA",3,FALSE);
  161.     if (gvp && (gv = *gvp) != (GV*)&sv_undef && (av = GvAV(gv))) {
  162.     SV** svp = AvARRAY(av);
  163.     I32 items = AvFILL(av) + 1;
  164.     while (items--) {
  165.         SV* sv = *svp++;
  166.         HV* basestash = gv_stashsv(sv, FALSE);
  167.         if (!basestash) {
  168.         if (dowarn)
  169.             warn("Can't locate package %s for @%s::ISA",
  170.             SvPVX(sv), HvNAME(stash));
  171.         continue;
  172.         }
  173.         gv = gv_fetchmeth(basestash, name, len, level + 1);
  174.         if (gv) {
  175.         if (cv) {                /* junk old undef */
  176.             assert(SvREFCNT(topgv) > 1);
  177.             SvREFCNT_dec(topgv);
  178.             SvREFCNT_dec(cv);
  179.         }
  180.         GvCV(topgv) = GvCV(gv);            /* cache the CV */
  181.         GvCVGEN(topgv) = sub_generation;    /* valid for now */
  182.         return gv;
  183.         }
  184.     }
  185.     }
  186.  
  187.     if (!level) {
  188.     if (lastchance = gv_stashpv("UNIVERSAL", FALSE)) {
  189.         if (gv = gv_fetchmeth(lastchance, name, len, level + 1)) {
  190.         if (cv) {                /* junk old undef */
  191.             assert(SvREFCNT(topgv) > 1);
  192.             SvREFCNT_dec(topgv);
  193.             SvREFCNT_dec(cv);
  194.         }
  195.         GvCV(topgv) = GvCV(gv);            /* cache the CV */
  196.         GvCVGEN(topgv) = sub_generation;    /* valid for now */
  197.         return gv;
  198.         }
  199.     }
  200.     }
  201.  
  202.     return 0;
  203. }
  204.  
  205. GV *
  206. gv_fetchmethod(stash, name)
  207. HV* stash;
  208. char* name;
  209. {
  210.     register char *nend;
  211.     char *nsplit = 0;
  212.     GV* gv;
  213.     
  214.     for (nend = name; *nend; nend++) {
  215.     if (*nend == ':' || *nend == '\'')
  216.         nsplit = nend;
  217.     }
  218.     if (nsplit) {
  219.     char ch;
  220.     char *origname = name;
  221.     name = nsplit + 1;
  222.     ch = *nsplit;
  223.     if (*nsplit == ':')
  224.         --nsplit;
  225.     *nsplit = '\0';
  226.     if (strEQ(origname,"SUPER")) {
  227.         /* Degenerate case ->SUPER::method should really lookup in original stash */
  228.         SV *tmpstr = sv_2mortal(newSVpv(HvNAME(curcop->cop_stash),0));
  229.         sv_catpvn(tmpstr, "::SUPER", 7);
  230.         stash = gv_stashpv(SvPV(tmpstr,na),TRUE);
  231.         *nsplit = ch;
  232.         DEBUG_o( deb("Treating %s as %s::%s\n",origname,HvNAME(stash),name) );
  233.     } else {
  234.         stash = gv_stashpv(origname,TRUE);
  235.         *nsplit = ch;
  236.     }
  237.     }
  238.     gv = gv_fetchmeth(stash, name, nend - name, 0);
  239.  
  240.     if (!gv) {
  241.     /* Failed obvious case - look for SUPER as last element of stash's name */
  242.     char *packname = HvNAME(stash);
  243.     STRLEN len     = strlen(packname);
  244.     if (len >= 7 && strEQ(packname+len-7,"::SUPER")) {
  245.         /* Now look for @.*::SUPER::ISA */
  246.         GV** gvp = (GV**)hv_fetch(stash,"ISA",3,FALSE);
  247.         if (!gvp || (gv = *gvp) == (GV*)&sv_undef || !GvAV(gv)) {
  248.         /* No @ISA in package ending in ::SUPER - drop suffix
  249.            and see if there is an @ISA there
  250.          */
  251.         HV *basestash;
  252.         char ch = packname[len-7];
  253.         AV *av;
  254.         packname[len-7] = '\0';
  255.         basestash = gv_stashpv(packname, TRUE);
  256.         packname[len-7] = ch;
  257.         gvp = (GV**)hv_fetch(basestash,"ISA",3,FALSE);
  258.         if (gvp && (gv = *gvp) != (GV*)&sv_undef && (av = GvAV(gv))) {
  259.              /* Okay found @ISA after dropping the SUPER, alias it */
  260.                  SV *tmpstr = sv_2mortal(newSVpv(HvNAME(stash),0));
  261.                  sv_catpvn(tmpstr, "::ISA", 5);
  262.              gv  = gv_fetchpv(SvPV(tmpstr,na),TRUE,SVt_PVGV);
  263.                      if (gv) {
  264.             GvAV(gv) = (AV*)SvREFCNT_inc(av);
  265.             /* ... and re-try lookup */
  266.             gv = gv_fetchmeth(stash, name, nend - name, 0);
  267.              } else {
  268.             croak("Cannot create %s::ISA",HvNAME(stash));
  269.              }
  270.         }
  271.         }
  272.     }     
  273.     }
  274.  
  275.     if (!gv) {
  276.     CV* cv;
  277.  
  278.     if (strEQ(name,"import") || strEQ(name,"unimport"))
  279.         gv = &sv_yes;
  280.     else if (strNE(name, "AUTOLOAD")) {
  281.         gv = gv_fetchmeth(stash, "AUTOLOAD", 8, 0);
  282.         if (gv && (cv = GvCV(gv))) { /* One more chance... */
  283.         SV *tmpstr = sv_2mortal(newSVpv(HvNAME(stash),0));
  284.         sv_catpvn(tmpstr,"::", 2);
  285.         sv_catpvn(tmpstr, name, nend - name);
  286.         sv_setsv(GvSV(CvGV(cv)), tmpstr);
  287.         if (tainting)
  288.             sv_unmagic(GvSV(CvGV(cv)), 't');
  289.         }
  290.     }
  291.     }
  292.     return gv;
  293. }
  294.  
  295. HV*
  296. gv_stashpv(name,create)
  297. char *name;
  298. I32 create;
  299. {
  300.     char tmpbuf[1234];
  301.     HV *stash;
  302.     GV *tmpgv;
  303.     /* Use strncpy to avoid bug in VMS sprintf */
  304.     /* sprintf(tmpbuf,"%.*s::",1200,name); */
  305.     strncpy(tmpbuf, name, 1200);
  306.     tmpbuf[1200] = '\0';  /* just in case . . . */
  307.     strcat(tmpbuf, "::");
  308.     tmpgv = gv_fetchpv(tmpbuf,create, SVt_PVHV);
  309.     if (!tmpgv)
  310.     return 0;
  311.     if (!GvHV(tmpgv))
  312.     GvHV(tmpgv) = newHV();
  313.     stash = GvHV(tmpgv);
  314.     if (!HvNAME(stash))
  315.     HvNAME(stash) = savepv(name);
  316.     return stash;
  317. }
  318.  
  319. HV*
  320. gv_stashsv(sv,create)
  321. SV *sv;
  322. I32 create;
  323. {
  324.     return gv_stashpv(SvPV(sv,na), create);
  325. }
  326.  
  327.  
  328. GV *
  329. gv_fetchpv(nambeg,add,sv_type)
  330. char *nambeg;
  331. I32 add;
  332. I32 sv_type;
  333. {
  334.     register char *name = nambeg;
  335.     register GV *gv = 0;
  336.     GV**gvp;
  337.     I32 len;
  338.     register char *namend;
  339.     HV *stash = 0;
  340.     bool global = FALSE;
  341.     char *tmpbuf;
  342.  
  343.     if (*name == '*' && isALPHA(name[1])) /* accidental stringify on a GV? */
  344.     name++;
  345.  
  346.     for (namend = name; *namend; namend++) {
  347.     if ((*namend == '\'' && namend[1]) ||
  348.         (*namend == ':' && namend[1] == ':'))
  349.     {
  350.         if (!stash)
  351.         stash = defstash;
  352.         if (!SvREFCNT(stash))    /* symbol table under destruction */
  353.         return Nullgv;
  354.  
  355.         len = namend - name;
  356.         if (len > 0) {
  357.         New(601, tmpbuf, len+3, char);
  358.         Copy(name, tmpbuf, len, char);
  359.         tmpbuf[len++] = ':';
  360.         tmpbuf[len++] = ':';
  361.         tmpbuf[len] = '\0';
  362.         gvp = (GV**)hv_fetch(stash,tmpbuf,len,add);
  363.         Safefree(tmpbuf);
  364.         if (!gvp || *gvp == (GV*)&sv_undef)
  365.             return Nullgv;
  366.         gv = *gvp;
  367.  
  368.         if (SvTYPE(gv) == SVt_PVGV)
  369.             GvMULTI_on(gv);
  370.         else if (!add)
  371.             return Nullgv;
  372.         else
  373.             gv_init(gv, stash, nambeg, namend - nambeg, (add & 2));
  374.  
  375.         if (!(stash = GvHV(gv)))
  376.             stash = GvHV(gv) = newHV();
  377.  
  378.         if (!HvNAME(stash))
  379.             HvNAME(stash) = savepvn(nambeg, namend - nambeg);
  380.         }
  381.  
  382.         if (*namend == ':')
  383.         namend++;
  384.         namend++;
  385.         name = namend;
  386.         if (!*name)
  387.         return gv ? gv : *hv_fetch(defstash, "main::", 6, TRUE);
  388.     }
  389.     }
  390.     len = namend - name;
  391.     if (!len)
  392.     len = 1;
  393.  
  394.     /* No stash in name, so see how we can default */
  395.  
  396.     if (!stash) {
  397.     if (isIDFIRST(*name)) {
  398.         if (isUPPER(*name)) {
  399.         if (*name > 'I') {
  400.             if (*name == 'S' && (
  401.               strEQ(name, "SIG") ||
  402.               strEQ(name, "STDIN") ||
  403.               strEQ(name, "STDOUT") ||
  404.               strEQ(name, "STDERR") ))
  405.             global = TRUE;
  406.         }
  407.         else if (*name > 'E') {
  408.             if (*name == 'I' && strEQ(name, "INC"))
  409.             global = TRUE;
  410.         }
  411.         else if (*name > 'A') {
  412.             if (*name == 'E' && strEQ(name, "ENV"))
  413.             global = TRUE;
  414.         }
  415.         else if (*name == 'A' && (
  416.           strEQ(name, "ARGV") ||
  417.           strEQ(name, "ARGVOUT") ))
  418.             global = TRUE;
  419.         }
  420.         else if (*name == '_' && !name[1])
  421.         global = TRUE;
  422.         if (global)
  423.         stash = defstash;
  424.         else if ((COP*)curcop == &compiling) {
  425.         stash = curstash;
  426.         if (add && (hints & HINT_STRICT_VARS) &&
  427.             sv_type != SVt_PVCV &&
  428.             sv_type != SVt_PVGV &&
  429.             sv_type != SVt_PVFM &&
  430.             sv_type != SVt_PVIO &&
  431.             !(len == 1 && sv_type == SVt_PV && strchr("ab",*name)) )
  432.         {
  433.             gvp = (GV**)hv_fetch(stash,name,len,0);
  434.             if (!gvp ||
  435.             *gvp == (GV*)&sv_undef ||
  436.             SvTYPE(*gvp) != SVt_PVGV)
  437.             {
  438.             stash = 0;
  439.             }
  440.             else if (sv_type == SVt_PV   && !GvIMPORTED_SV(*gvp) ||
  441.                  sv_type == SVt_PVAV && !GvIMPORTED_AV(*gvp) ||
  442.                  sv_type == SVt_PVHV && !GvIMPORTED_HV(*gvp) )
  443.             {
  444.             warn("Variable \"%c%s\" is not imported",
  445.                 sv_type == SVt_PVAV ? '@' :
  446.                 sv_type == SVt_PVHV ? '%' : '$',
  447.                 name);
  448.             if (GvCV(*gvp))
  449.                 warn("(Did you mean &%s instead?)\n", name);
  450.             stash = 0;
  451.             }
  452.         }
  453.         }
  454.         else
  455.         stash = curcop->cop_stash;
  456.     }
  457.     else
  458.         stash = defstash;
  459.     }
  460.  
  461.     /* By this point we should have a stash and a name */
  462.  
  463.     if (!stash) {
  464.     if (add) {
  465.         warn("Global symbol \"%s\" requires explicit package name", name);
  466.         ++error_count;
  467.         stash = curstash ? curstash : defstash;    /* avoid core dumps */
  468.     }
  469.     else
  470.         return Nullgv;
  471.     }
  472.  
  473.     if (!SvREFCNT(stash))    /* symbol table under destruction */
  474.     return Nullgv;
  475.  
  476.     gvp = (GV**)hv_fetch(stash,name,len,add);
  477.     if (!gvp || *gvp == (GV*)&sv_undef)
  478.     return Nullgv;
  479.     gv = *gvp;
  480.     if (SvTYPE(gv) == SVt_PVGV) {
  481.     if (add) {
  482.         GvMULTI_on(gv);
  483.         gv_init_sv(gv, sv_type);
  484.     }
  485.     return gv;
  486.     }
  487.  
  488.     /* Adding a new symbol */
  489.  
  490.     if (add & 4)
  491.     warn("Had to create %s unexpectedly", nambeg);
  492.     gv_init(gv, stash, name, len, add & 2);
  493.     gv_init_sv(gv, sv_type);
  494.  
  495.     /* set up magic where warranted */
  496.     switch (*name) {
  497.     case 'A':
  498.     if (strEQ(name, "ARGV")) {
  499.         IoFLAGS(GvIOn(gv)) |= IOf_ARGV|IOf_START;
  500.     }
  501.     break;
  502.  
  503.     case 'a':
  504.     case 'b':
  505.     if (len == 1)
  506.         GvMULTI_on(gv);
  507.     break;
  508.     case 'E':
  509.     if (strnEQ(name, "EXPORT", 6))
  510.         GvMULTI_on(gv);
  511.     break;
  512.     case 'I':
  513.     if (strEQ(name, "ISA")) {
  514.         AV* av = GvAVn(gv);
  515.         GvMULTI_on(gv);
  516.         sv_magic((SV*)av, (SV*)gv, 'I', Nullch, 0);
  517.         if (add & 2 && strEQ(nambeg,"AnyDBM_File::ISA") && AvFILL(av) == -1)
  518.         {
  519.         char *pname;
  520.         av_push(av, newSVpv(pname = "NDBM_File",0));
  521.         gv_stashpv(pname, TRUE);
  522.         av_push(av, newSVpv(pname = "DB_File",0));
  523.         gv_stashpv(pname, TRUE);
  524.         av_push(av, newSVpv(pname = "GDBM_File",0));
  525.         gv_stashpv(pname, TRUE);
  526.         av_push(av, newSVpv(pname = "SDBM_File",0));
  527.         gv_stashpv(pname, TRUE);
  528.         av_push(av, newSVpv(pname = "ODBM_File",0));
  529.         gv_stashpv(pname, TRUE);
  530.         }
  531.     }
  532.     break;
  533. #ifdef OVERLOAD
  534.     case 'O':
  535.         if (strEQ(name, "OVERLOAD")) {
  536.             HV* hv = GvHVn(gv);
  537.             GvMULTI_on(gv);
  538.             sv_magic((SV*)hv, (SV*)gv, 'A', 0, 0);
  539.         }
  540.         break;
  541. #endif /* OVERLOAD */
  542.     case 'S':
  543.     if (strEQ(name, "SIG")) {
  544.         HV *hv;
  545.         siggv = gv;
  546.         GvMULTI_on(siggv);
  547.         hv = GvHVn(siggv);
  548.         hv_magic(hv, siggv, 'S');
  549.  
  550.         /* initialize signal stack */
  551.         signalstack = newAV();
  552.         AvREAL_off(signalstack);
  553.         av_extend(signalstack, 30);
  554.         av_fill(signalstack, 0);
  555.     }
  556.     break;
  557.  
  558.     case '&':
  559.     if (len > 1)
  560.         break;
  561.     ampergv = gv;
  562.     sawampersand = TRUE;
  563.     goto ro_magicalize;
  564.  
  565.     case '`':
  566.     if (len > 1)
  567.         break;
  568.     leftgv = gv;
  569.     sawampersand = TRUE;
  570.     goto ro_magicalize;
  571.  
  572.     case '\'':
  573.     if (len > 1)
  574.         break;
  575.     rightgv = gv;
  576.     sawampersand = TRUE;
  577.     goto ro_magicalize;
  578.  
  579.     case ':':
  580.     if (len > 1)
  581.         break;
  582.     sv_setpv(GvSV(gv),chopset);
  583.     goto magicalize;
  584.  
  585.     case '#':
  586.     case '*':
  587.     if (dowarn && len == 1 && sv_type == SVt_PV)
  588.         warn("Use of $%s is deprecated", name);
  589.     /* FALL THROUGH */
  590.     case '[':
  591.     case '!':
  592.     case '?':
  593.     case '^':
  594.     case '~':
  595.     case '=':
  596.     case '-':
  597.     case '%':
  598.     case '.':
  599.     case '(':
  600.     case ')':
  601.     case '<':
  602.     case '>':
  603.     case ',':
  604.     case '\\':
  605.     case '/':
  606.     case '|':
  607.     case '\001':
  608.     case '\004':
  609.     case '\006':
  610.     case '\010':
  611.     case '\t':
  612.     case '\020':
  613.     case '\024':
  614.     case '\027':
  615.     if (len > 1)
  616.         break;
  617.     goto magicalize;
  618.  
  619.     case '+':
  620.     case '1':
  621.     case '2':
  622.     case '3':
  623.     case '4':
  624.     case '5':
  625.     case '6':
  626.     case '7':
  627.     case '8':
  628.     case '9':
  629.       ro_magicalize:
  630.     SvREADONLY_on(GvSV(gv));
  631.       magicalize:
  632.     sv_magic(GvSV(gv), (SV*)gv, 0, name, len);
  633.     break;
  634.  
  635.     case '\014':
  636.     if (len > 1)
  637.         break;
  638.     sv_setpv(GvSV(gv),"\f");
  639.     formfeed = GvSV(gv);
  640.     break;
  641.     case ';':
  642.     if (len > 1)
  643.         break;
  644.     sv_setpv(GvSV(gv),"\034");
  645.     break;
  646.     case ']':
  647.     if (len == 1) {
  648.         SV *sv;
  649.         sv = GvSV(gv);
  650.         sv_upgrade(sv, SVt_PVNV);
  651.         sv_setpv(sv, patchlevel);
  652.     }
  653.     break;
  654.     }
  655.     return gv;
  656. }
  657.  
  658. void
  659. gv_fullname(sv,gv)
  660. SV *sv;
  661. GV *gv;
  662. {
  663.     HV *hv = GvSTASH(gv);
  664.  
  665.     if (!hv)
  666.     return;
  667.     sv_setpv(sv, sv == (SV*)gv ? "*" : "");
  668.     sv_catpv(sv,HvNAME(hv));
  669.     sv_catpvn(sv,"::", 2);
  670.     sv_catpvn(sv,GvNAME(gv),GvNAMELEN(gv));
  671. }
  672.  
  673. void
  674. gv_efullname(sv,gv)
  675. SV *sv;
  676. GV *gv;
  677. {
  678.     GV* egv = GvEGV(gv);
  679.     HV *hv;
  680.     
  681.     if (!egv)
  682.     egv = gv;
  683.     hv = GvSTASH(egv);
  684.     if (!hv)
  685.     return;
  686.  
  687.     sv_setpv(sv, sv == (SV*)gv ? "*" : "");
  688.     sv_catpv(sv,HvNAME(hv));
  689.     sv_catpvn(sv,"::", 2);
  690.     sv_catpvn(sv,GvNAME(egv),GvNAMELEN(egv));
  691. }
  692.  
  693. IO *
  694. newIO()
  695. {
  696.     IO *io;
  697.     GV *iogv;
  698.  
  699.     io = (IO*)NEWSV(0,0);
  700.     sv_upgrade((SV *)io,SVt_PVIO);
  701.     SvREFCNT(io) = 1;
  702.     SvOBJECT_on(io);
  703.     iogv = gv_fetchpv("FileHandle::", TRUE, SVt_PVHV);
  704.     SvSTASH(io) = (HV*)SvREFCNT_inc(GvHV(iogv));
  705.     return io;
  706. }
  707.  
  708. void
  709. gv_check(stash)
  710. HV* stash;
  711. {
  712.     register HE *entry;
  713.     register I32 i;
  714.     register GV *gv;
  715.     HV *hv;
  716.     GV *filegv;
  717.  
  718.     if (!HvARRAY(stash))
  719.     return;
  720.     for (i = 0; i <= (I32) HvMAX(stash); i++) {
  721.     for (entry = HvARRAY(stash)[i]; entry; entry = entry->hent_next) {
  722.         if (entry->hent_key[entry->hent_klen-1] == ':' &&
  723.         (gv = (GV*)entry->hent_val) && (hv = GvHV(gv)) && HvNAME(hv))
  724.         {
  725.         if (hv != defstash)
  726.              gv_check(hv);              /* nested package */
  727.         }
  728.         else if (isALPHA(*entry->hent_key)) {
  729.         gv = (GV*)entry->hent_val;
  730.         if (GvMULTI(gv))
  731.             continue;
  732.         curcop->cop_line = GvLINE(gv);
  733.         filegv = GvFILEGV(gv);
  734.         curcop->cop_filegv = filegv;
  735.         if (filegv && GvMULTI(filegv))    /* Filename began with slash */
  736.             continue;
  737.         warn("Identifier \"%s::%s\" used only once: possible typo",
  738.             HvNAME(stash), GvNAME(gv));
  739.         }
  740.     }
  741.     }
  742. }
  743.  
  744. GV *
  745. newGVgen(pack)
  746. char *pack;
  747. {
  748.     (void)sprintf(tokenbuf,"%s::_GEN_%ld",pack,(long)gensym++);
  749.     return gv_fetchpv(tokenbuf,TRUE, SVt_PVGV);
  750. }
  751.  
  752. /* hopefully this is only called on local symbol table entries */
  753.  
  754. GP*
  755. gp_ref(gp)
  756. GP* gp;
  757. {
  758.     gp->gp_refcnt++;
  759.     return gp;
  760.  
  761. }
  762.  
  763. void
  764. gp_free(gv)
  765. GV* gv;
  766. {
  767.     GP* gp;
  768.     CV* cv;
  769.  
  770.     if (!gv || !(gp = GvGP(gv)))
  771.     return;
  772.     if (gp->gp_refcnt == 0) {
  773.         warn("Attempt to free unreferenced glob pointers");
  774.         return;
  775.     }
  776.     if (--gp->gp_refcnt > 0) {
  777.     if (gp->gp_egv == gv)
  778.         gp->gp_egv = 0;
  779.         return;
  780.     }
  781.  
  782.     SvREFCNT_dec(gp->gp_sv);
  783.     SvREFCNT_dec(gp->gp_av);
  784.     SvREFCNT_dec(gp->gp_hv);
  785.     SvREFCNT_dec(gp->gp_io);
  786.     if ((cv = gp->gp_cv) && !GvCVGEN(gv))
  787.     SvREFCNT_dec(cv);
  788.     SvREFCNT_dec(gp->gp_form);
  789.  
  790.     Safefree(gp);
  791.     GvGP(gv) = 0;
  792. }
  793.  
  794. #if defined(CRIPPLED_CC) && (defined(iAPX286) || defined(M_I286) || defined(I80286))
  795. #define MICROPORT
  796. #endif
  797.  
  798. #ifdef    MICROPORT    /* Microport 2.4 hack */
  799. AV *GvAVn(gv)
  800. register GV *gv;
  801. {
  802.     if (GvGP(gv)->gp_av) 
  803.     return GvGP(gv)->gp_av;
  804.     else
  805.     return GvGP(gv_AVadd(gv))->gp_av;
  806. }
  807.  
  808. HV *GvHVn(gv)
  809. register GV *gv;
  810. {
  811.     if (GvGP(gv)->gp_hv)
  812.     return GvGP(gv)->gp_hv;
  813.     else
  814.     return GvGP(gv_HVadd(gv))->gp_hv;
  815. }
  816. #endif            /* Microport 2.4 hack */
  817.  
  818. #ifdef OVERLOAD
  819. /* Updates and caches the CV's */
  820.  
  821. bool
  822. Gv_AMupdate(stash)
  823. HV* stash;
  824. {
  825.   GV** gvp;
  826.   HV* hv;
  827.   GV* gv;
  828.   CV* cv;
  829.   MAGIC* mg=mg_find((SV*)stash,'c');
  830.   AMT *amtp=mg ? (AMT*)mg->mg_ptr: NULL;
  831.  
  832.   if (mg && (amtp=((AMT*)(mg->mg_ptr)))->was_ok_am == amagic_generation &&
  833.              amtp->was_ok_sub == sub_generation)
  834.       return HV_AMAGIC(stash)? TRUE: FALSE;
  835.   gvp=(GV**)hv_fetch(stash,"OVERLOAD",8,FALSE);
  836.   if (amtp && amtp->table) {
  837.     int i;
  838.     for (i=1;i<NofAMmeth*2;i++) {
  839.       if (amtp->table[i]) {
  840.     SvREFCNT_dec(amtp->table[i]);
  841.       }
  842.     }
  843.   }
  844.   sv_unmagic((SV*)stash, 'c');
  845.  
  846.   DEBUG_o( deb("Recalcing overload magic in package %s\n",HvNAME(stash)) );
  847.  
  848.   if (gvp && ((gv = *gvp) != (GV*)&sv_undef && (hv = GvHV(gv)))) {
  849.     int filled=0;
  850.     int i;
  851.     char *cp;
  852.     AMT amt;
  853.     SV* sv;
  854.     SV** svp;
  855.  
  856. /*  if (*(svp)==(SV*)amagic_generation && *(svp+1)==(SV*)sub_generation) {
  857.       DEBUG_o( deb("Overload magic in package %s up-to-date\n",HvNAME(stash))
  858. );
  859.       return HV_AMAGIC(stash)? TRUE: FALSE;
  860.     }*/
  861.  
  862.     amt.was_ok_am=amagic_generation;
  863.     amt.was_ok_sub=sub_generation;
  864.     amt.fallback=AMGfallNO;
  865.  
  866.     /* Work with "fallback" key, which we assume to be first in AMG_names */
  867.  
  868.     if ((cp=((char**)(*AMG_names))[0]) &&
  869.     (svp=(SV**)hv_fetch(hv,cp,strlen(cp),FALSE)) && (sv = *svp)) {
  870.       if (SvTRUE(sv)) amt.fallback=AMGfallYES;
  871.       else if (SvOK(sv)) amt.fallback=AMGfallNEVER;
  872.     }
  873.  
  874.     for (i=1;i<NofAMmeth*2;i++) {
  875.       cv=0;
  876.  
  877.       if ( (cp=((char**)(*AMG_names))[i]) ) {
  878.         svp=(SV**)hv_fetch(hv,cp,strlen(cp),FALSE);
  879.         if (svp && ((sv = *svp) != (GV*)&sv_undef)) {
  880.           switch (SvTYPE(sv)) {
  881.             default:
  882.               if (!SvROK(sv)) {
  883.                 if (!SvOK(sv)) break;
  884.         gv = gv_fetchmethod(stash, SvPV(sv, na));
  885.                 if (gv) cv = GvCV(gv);
  886.                 break;
  887.               }
  888.               cv = (CV*)SvRV(sv);
  889.               if (SvTYPE(cv) == SVt_PVCV)
  890.                   break;
  891.                 /* FALL THROUGH */
  892.             case SVt_PVHV:
  893.             case SVt_PVAV:
  894.           die("Not a subroutine reference in %%OVERLOAD");
  895.           return FALSE;
  896.             case SVt_PVCV:
  897.                 cv = (CV*)sv;
  898.                 break;
  899.             case SVt_PVGV:
  900.                 if (!(cv = GvCV((GV*)sv)))
  901.                     cv = sv_2cv(sv, &stash, &gv, TRUE);
  902.                 break;
  903.           }
  904.           if (cv) filled=1;
  905.       else {
  906.         die("Method for operation %s not found in package %.256s during blessing\n",
  907.         cp,HvNAME(stash));
  908.         return FALSE;
  909.       }
  910.         }
  911.       }
  912.       amt.table[i]=(CV*)SvREFCNT_inc(cv);
  913.     }
  914.     sv_magic((SV*)stash, 0, 'c', (char*)&amt, sizeof(amt));
  915.     if (filled) {
  916. /*    HV_badAMAGIC_off(stash);*/
  917.       HV_AMAGIC_on(stash);
  918.       return TRUE;
  919.     }
  920.   }
  921. /*HV_badAMAGIC_off(stash);*/
  922.   HV_AMAGIC_off(stash);
  923.   return FALSE;
  924. }
  925.  
  926. /* During call to this subroutine stack can be reallocated. It is
  927.  * advised to call SPAGAIN macro in your code after call */
  928.  
  929. SV*
  930. amagic_call(left,right,method,flags)
  931. SV* left;
  932. SV* right;
  933. int method;
  934. int flags; 
  935. {
  936.   MAGIC *mg; 
  937.   CV *cv; 
  938.   CV **cvp=NULL, **ocvp=NULL;
  939.   AMT *amtp, *oamtp;
  940.   int fl=0, off, off1, lr=0, assign=AMGf_assign & flags, notfound=0;
  941.   int postpr=0, inc_dec_ass=0, assignshift=assign?1:0;
  942.   HV* stash;
  943.   if (!(AMGf_noleft & flags) && SvAMAGIC(left)
  944.       && (mg = mg_find((SV*)(stash=SvSTASH(SvRV(left))),'c'))
  945.       && (ocvp = cvp = ((oamtp=amtp=(AMT*)mg->mg_ptr)->table))
  946.       && ((cv = cvp[off=method+assignshift]) 
  947.       || (assign && amtp->fallback > AMGfallNEVER && /* fallback to
  948.                                   * usual method */
  949.           (fl = 1, cv = cvp[off=method])))) {
  950.     lr = -1;            /* Call method for left argument */
  951.   } else {
  952.     if (cvp && amtp->fallback > AMGfallNEVER && flags & AMGf_unary) {
  953.       int logic;
  954.  
  955.       /* look for substituted methods */
  956.      switch (method) {
  957.      case inc_amg:
  958.        if (((cv = cvp[off=add_ass_amg]) && (inc_dec_ass=1))
  959.            || ((cv = cvp[off=add_amg]) && (postpr=1))) {
  960.          right = &sv_yes; lr = -1; assign = 1;
  961.        }
  962.        break;
  963.      case dec_amg:
  964.        if (((cv = cvp[off=subtr_ass_amg])  && (inc_dec_ass=1))
  965.            || ((cv = cvp[off=subtr_amg]) && (postpr=1))) {
  966.          right = &sv_yes; lr = -1; assign = 1;
  967.        }
  968.        break;
  969.      case bool__amg:
  970.        (void)((cv = cvp[off=numer_amg]) || (cv = cvp[off=string_amg]));
  971.        break;
  972.      case numer_amg:
  973.        (void)((cv = cvp[off=string_amg]) || (cv = cvp[off=bool__amg]));
  974.        break;
  975.      case string_amg:
  976.        (void)((cv = cvp[off=numer_amg]) || (cv = cvp[off=bool__amg]));
  977.        break;
  978.      case copy_amg:
  979.        {
  980.          SV* ref=SvRV(left);
  981.          if (!SvROK(ref) && SvTYPE(ref) <= SVt_PVMG) { /* Just to be
  982.                               * extra
  983.                               * causious,
  984.                               * maybe in some
  985.                               * additional
  986.                               * cases sv_setsv
  987.                               * is safe too */
  988.         SV* newref = newSVsv(ref);
  989.         SvOBJECT_on(newref);
  990.         SvSTASH(newref) = (HV*)SvREFCNT_inc(SvSTASH(ref));
  991.         return newref;
  992.          }
  993.        }
  994.        break;
  995.      case abs_amg:
  996.        if ((cvp[off1=lt_amg] || cvp[off1=ncmp_amg]) 
  997.            && ((cv = cvp[off=neg_amg]) || (cv = cvp[off=subtr_amg]))) {
  998.          SV* nullsv=sv_2mortal(newSViv(0));
  999.          if (off1==lt_amg) {
  1000.            SV* lessp = amagic_call(left,nullsv,
  1001.                        lt_amg,AMGf_noright);
  1002.            logic = SvTRUE(lessp);
  1003.          } else {
  1004.            SV* lessp = amagic_call(left,nullsv,
  1005.                        ncmp_amg,AMGf_noright);
  1006.            logic = (SvNV(lessp) < 0);
  1007.          }
  1008.          if (logic) {
  1009.            if (off==subtr_amg) {
  1010.          right = left;
  1011.          left = nullsv;
  1012.          lr = 1;
  1013.            }
  1014.          } else {
  1015.            return left;
  1016.          }
  1017.        }
  1018.        break;
  1019.      case neg_amg:
  1020.        if (cv = cvp[off=subtr_amg]) {
  1021.          right = left;
  1022.          left = sv_2mortal(newSViv(0));
  1023.          lr = 1;
  1024.        }
  1025.        break;
  1026.      default:
  1027.        goto not_found;
  1028.      }
  1029.      if (!cv) goto not_found;
  1030.     } else if (!(AMGf_noright & flags) && SvAMAGIC(right)
  1031.            && (mg = mg_find((SV*)(stash=SvSTASH(SvRV(right))),'c'))
  1032.            && (cvp = ((amtp=(AMT*)mg->mg_ptr)->table))
  1033.            && (cv = cvp[off=method])) { /* Method for right
  1034.                          * argument found */
  1035.       lr=1;
  1036.     } else if (((ocvp && oamtp->fallback > AMGfallNEVER 
  1037.          && (cvp=ocvp) && (lr = -1)) 
  1038.         || (cvp && amtp->fallback > AMGfallNEVER && (lr=1)))
  1039.            && !(flags & AMGf_unary)) {
  1040.                 /* We look for substitution for
  1041.                  * comparison operations and
  1042.                  * concatendation */
  1043.       if (method==concat_amg || method==concat_ass_amg
  1044.       || method==repeat_amg || method==repeat_ass_amg) {
  1045.     return NULL;        /* Delegate operation to string conversion */
  1046.       }
  1047.       off = -1;
  1048.       switch (method) {
  1049.      case lt_amg:
  1050.      case le_amg:
  1051.      case gt_amg:
  1052.      case ge_amg:
  1053.      case eq_amg:
  1054.      case ne_amg:
  1055.        postpr = 1; off=ncmp_amg; break;
  1056.      case slt_amg:
  1057.      case sle_amg:
  1058.      case sgt_amg:
  1059.      case sge_amg:
  1060.      case seq_amg:
  1061.      case sne_amg:
  1062.        postpr = 1; off=scmp_amg; break;
  1063.      }
  1064.       if (off != -1) cv = cvp[off];
  1065.       if (!cv) {
  1066.     goto not_found;
  1067.       }
  1068.     } else {
  1069.     not_found:            /* No method found, either report or die */
  1070.       if (ocvp && (cv=ocvp[nomethod_amg])) { /* Call report method */
  1071.     notfound = 1; lr = -1;
  1072.       } else if (cvp && (cv=cvp[nomethod_amg])) {
  1073.     notfound = 1; lr = 1;
  1074.       } else {
  1075.         if (off==-1) off=method;
  1076.     sprintf(buf, "Operation `%s': no method found,\n\tleft argument %s%.256s,\n\tright argument %s%.256s",
  1077.               ((char**)AMG_names)[method + assignshift],
  1078.               SvAMAGIC(left)? 
  1079.                 "in overloaded package ":
  1080.                 "has no overloaded magic",
  1081.               SvAMAGIC(left)? 
  1082.                 HvNAME(SvSTASH(SvRV(left))):
  1083.                 "",
  1084.               SvAMAGIC(right)? 
  1085.                 "in overloaded package ":
  1086.                 "has no overloaded magic",
  1087.               SvAMAGIC(right)? 
  1088.                 HvNAME(SvSTASH(SvRV(right))):
  1089.                 "");
  1090.     if (amtp && amtp->fallback >= AMGfallYES) {
  1091.       DEBUG_o( deb(buf) );
  1092.     } else {
  1093.       die(buf);
  1094.     }
  1095.     return NULL;
  1096.       }
  1097.     }
  1098.   }
  1099.   if (!notfound) {
  1100.     DEBUG_o( deb("Overloaded operator `%s'%s%s%s:\n\tmethod%s found%s in package %.256s%s\n",
  1101.          ((char**)AMG_names)[off],
  1102.          method+assignshift==off? "" :
  1103.                      " (initially `",
  1104.          method+assignshift==off? "" :
  1105.                      ((char**)AMG_names)[method+assignshift],
  1106.          method+assignshift==off? "" : "')",
  1107.          flags & AMGf_unary? "" :
  1108.            lr==1 ? " for right argument": " for left argument",
  1109.          flags & AMGf_unary? " for argument" : "",
  1110.          HvNAME(stash), 
  1111.          fl? ",\n\tassignment variant used": "") );
  1112.     /* Since we use shallow copy during assignment, we need
  1113.      * to dublicate the contents, probably calling user-supplied
  1114.      * version of copy operator
  1115.      */
  1116.     if ((method + assignshift==off 
  1117.      && (assign || method==inc_amg || method==dec_amg))
  1118.     || inc_dec_ass) RvDEEPCP(left);
  1119.   }
  1120.   {
  1121.     dSP;
  1122.     BINOP myop;
  1123.     SV* res;
  1124.  
  1125.     Zero(&myop, 1, BINOP);
  1126.     myop.op_last = (OP *) &myop;
  1127.     myop.op_next = Nullop;
  1128.     myop.op_flags = OPf_KNOW|OPf_STACKED;
  1129.  
  1130.     ENTER;
  1131.     SAVESPTR(op);
  1132.     op = (OP *) &myop;
  1133.     PUTBACK;
  1134.     pp_pushmark();
  1135.  
  1136.     EXTEND(sp, notfound + 5);
  1137.     PUSHs(lr>0? right: left);
  1138.     PUSHs(lr>0? left: right);
  1139.     PUSHs( assign ? &sv_undef : (lr>0? &sv_yes: &sv_no));
  1140.     if (notfound) {
  1141.       PUSHs( sv_2mortal(newSVpv(((char**)AMG_names)[method + assignshift],0)) );
  1142.     }
  1143.     PUSHs((SV*)cv);
  1144.     PUTBACK;
  1145.  
  1146.     if (op = pp_entersub())
  1147.       run();
  1148.     LEAVE;
  1149.     SPAGAIN;
  1150.  
  1151.     res=POPs;
  1152.     PUTBACK;
  1153.  
  1154.     if (notfound) {
  1155.       /* sv_2mortal(res); */
  1156.       return NULL;
  1157.     }
  1158.  
  1159.     if (postpr) {
  1160.       int ans;
  1161.       switch (method) {
  1162.       case le_amg:
  1163.       case sle_amg:
  1164.     ans=SvIV(res)<=0; break;
  1165.       case lt_amg:
  1166.       case slt_amg:
  1167.     ans=SvIV(res)<0; break;
  1168.       case ge_amg:
  1169.       case sge_amg:
  1170.     ans=SvIV(res)>=0; break;
  1171.       case gt_amg:
  1172.       case sgt_amg:
  1173.     ans=SvIV(res)>0; break;
  1174.       case eq_amg:
  1175.       case seq_amg:
  1176.     ans=SvIV(res)==0; break;
  1177.       case ne_amg:
  1178.       case sne_amg:
  1179.     ans=SvIV(res)!=0; break;
  1180.       case inc_amg:
  1181.       case dec_amg:
  1182.     SvSetSV(left,res); return res; break;
  1183.       }
  1184.       return ans? &sv_yes: &sv_no;
  1185.     } else if (method==copy_amg) {
  1186.       if (!SvROK(res)) {
  1187.     die("Copy method did not return a reference");
  1188.       }
  1189.       return SvREFCNT_inc(SvRV(res));
  1190.     } else {
  1191.       return res;
  1192.     }
  1193.   }
  1194. }
  1195. #endif /* OVERLOAD */
  1196.